Validate CVV

Validating Card Verification Value (CVV) of card.

Method: POST

{{URL}}/cardv2

Headers

Name	Value
Content-Type	application/json

Payload Parameters

Parameters	Description
transactionType Mandatory	String Type of operation / transaction Constant Value: "VALIDATE_CVV"
product Mandatory	String Name of the product associated with the card Sample Value: "DEFAULT"
channel Mandatory	Enum Processing channel through which the card transaction happens Valid Values: PULSE VISA_DPS Sample Value: "VISA_DPS"
program Mandatory	String Name of the program to which the card product is mapped Sample Value: "DEFAULT"
cardId Mandatory	String Unique ID of the card Sample Value: "6f586be7bf1c44b8b4ea11b2e2510e25"
cardCvv Mandatory	String Encrypted Card Verification Value (CVV) of the card given for validation Sample Value: "fbbVg8NQFDwa5rtkjR+Wa4wqiZwUWoxaUVLO2fTFgeYvQ9RGBfyl6H0rpCvtEoEbhbVFTuJGX8hdgjfptOynnrKD5DUFpK0RDi+URuKIunzbiQ9Gq6iqs54S2LaWH0ZVwsvPb4HiP1mOX88oV7xZc7rzWcG1nOBErogItPTijlG/UMvVWU0SYMd+fjBNqMcdMeFe3GLch3KMFpAC4yC+sTSyLj9W8C0vOhF2bA3voxX2Vb5Xv27oR8Xn6jKoR+/ZzK0Ch3aF06P+Xxto/ZGZyvdxsN+s2ldEu+vHbK6QwXC30/U+J8TFOQ0rIbZny3LOtaBK0sbflAdLNlQwaFmCfQ=="
isEncrypt Mandatory	String CVV should be mandatorily encrypted to ensure protection of card holder information Constant Value: "true"

cURL

curl --location --globoff --request GET '{{URL}}/cardv2' \
--header 'Content-Type: application/json' \
--data '{"method":"ledger.CARD.request","id":"1","params":{"payload":{"transactionType":"VALIDATE_CVV","product":"DEFAULT","channel":"VISA_DPS","program":"DEFAULT","cardId":"6f586be7bf1c44b8b4ea11b2e2510e25","cardCvv":"fbbVg8NQFDwa5rtkjR+Wa4wqiZwUWoxaUVLO2fTFgeYvQ9RGBfyl6H0rpCvtEoEbhbVFTuJGX8hdgjfptOynnrKD5DUFpK0RDi+URuKIunzbiQ9Gq6iqs54S2LaWH0ZVwsvPb4HiP1mOX88oV7xZc7rzWcG1nOBErogItPTijlG/UMvVWU0SYMd+fjBNqMcdMeFe3GLch3KMFpAC4yC+sTSyLj9W8C0vOhF2bA3voxX2Vb5Xv27oR8Xn6jKoR+/ZzK0Ch3aF06P+Xxto/ZGZyvdxsN+s2ldEu+vHbK6QwXC30/U+J8TFOQ0rIbZny3LOtaBK0sbflAdLNlQwaFmCfQ==","isEncrypt":true},"api":{"signature":"{{signature}}","apiKey":"{{Api-key}}","credential":"{{cred}}"}}}'

C#

using System;
using RestSharp;
using System.Threading;
using System.Threading.Tasks;
namespace HelloWorldApplication {
  class HelloWorld {
    static async Task Main(string[] args) {
      var options = new RestClientOptions("{{URL}}/cardv2")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Get);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"    ""method"": ""ledger.CARD.request"",
" + "\n" +
@"    ""id"": ""1"",
" + "\n" +
@"    ""params"": {
" + "\n" +
@"        ""payload"": {
" + "\n" +
@"            ""transactionType"": ""VALIDATE_CVV"",
" + "\n" +
@"            ""product"": ""DEFAULT"",
" + "\n" +
@"            ""channel"": ""VISA_DPS"",
" + "\n" +
@"            ""program"": ""DEFAULT"",
" + "\n" +
@"            ""cardId"": ""6f586be7bf1c44b8b4ea11b2e2510e25"",
" + "\n" +
@"            ""cardCvv"": ""fbbVg8NQFDwa5rtkjR+Wa4wqiZwUWoxaUVLO2fTFgeYvQ9RGBfyl6H0rpCvtEoEbhbVFTuJGX8hdgjfptOynnrKD5DUFpK0RDi+URuKIunzbiQ9Gq6iqs54S2LaWH0ZVwsvPb4HiP1mOX88oV7xZc7rzWcG1nOBErogItPTijlG/UMvVWU0SYMd+fjBNqMcdMeFe3GLch3KMFpAC4yC+sTSyLj9W8C0vOhF2bA3voxX2Vb5Xv27oR8Xn6jKoR+/ZzK0Ch3aF06P+Xxto/ZGZyvdxsN+s2ldEu+vHbK6QwXC30/U+J8TFOQ0rIbZny3LOtaBK0sbflAdLNlQwaFmCfQ=="",
" + "\n" +
@"            ""isEncrypt"": true
" + "\n" +
@"        },
" + "\n" +
@"        ""api"": {
" + "\n" +
@"            ""signature"": ""{{signature}}"",
" + "\n" +
@"            ""apiKey"": ""{{Api-key}}"",
" + "\n" +
@"            ""credential"": ""{{cred}}""
" + "\n" +
@"        }
" + "\n" +
@"    }
" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);
  }
}

Go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "{{URL}}/cardv2"
  method := "GET"

  payload := strings.NewReader(`{`+"
"+`
    "method": "ledger.CARD.request",`+"
"+`
    "id": "1",`+"
"+`
    "params": {`+"
"+`
        "payload": {`+"
"+`
            "transactionType": "VALIDATE_CVV",`+"
"+`
            "product": "DEFAULT",`+"
"+`
            "channel": "VISA_DPS",`+"
"+`
            "program": "DEFAULT",`+"
"+`
            "cardId": "6f586be7bf1c44b8b4ea11b2e2510e25",`+"
"+`
            "cardCvv": "fbbVg8NQFDwa5rtkjR+Wa4wqiZwUWoxaUVLO2fTFgeYvQ9RGBfyl6H0rpCvtEoEbhbVFTuJGX8hdgjfptOynnrKD5DUFpK0RDi+URuKIunzbiQ9Gq6iqs54S2LaWH0ZVwsvPb4HiP1mOX88oV7xZc7rzWcG1nOBErogItPTijlG/UMvVWU0SYMd+fjBNqMcdMeFe3GLch3KMFpAC4yC+sTSyLj9W8C0vOhF2bA3voxX2Vb5Xv27oR8Xn6jKoR+/ZzK0Ch3aF06P+Xxto/ZGZyvdxsN+s2ldEu+vHbK6QwXC30/U+J8TFOQ0rIbZny3LOtaBK0sbflAdLNlQwaFmCfQ==",`+"
"+`
            "isEncrypt": true`+"
"+`
        },`+"
"+`
        "api": {`+"
"+`
            "signature": "{{signature}}",`+"
"+`
            "apiKey": "{{Api-key}}",`+"
"+`
            "credential": "{{cred}}"`+"
"+`
        }`+"
"+`
    }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

NodeJs

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'GET',
  'hostname': '{{URL}}',
  'path': '/cardv2',
  'headers': {
    'Content-Type': 'application/json'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "method": "ledger.CARD.request",
  "id": "1",
  "params": {
    "payload": {
      "transactionType": "VALIDATE_CVV",
      "product": "DEFAULT",
      "channel": "VISA_DPS",
      "program": "DEFAULT",
      "cardId": "6f586be7bf1c44b8b4ea11b2e2510e25",
      "cardCvv": "fbbVg8NQFDwa5rtkjR+Wa4wqiZwUWoxaUVLO2fTFgeYvQ9RGBfyl6H0rpCvtEoEbhbVFTuJGX8hdgjfptOynnrKD5DUFpK0RDi+URuKIunzbiQ9Gq6iqs54S2LaWH0ZVwsvPb4HiP1mOX88oV7xZc7rzWcG1nOBErogItPTijlG/UMvVWU0SYMd+fjBNqMcdMeFe3GLch3KMFpAC4yC+sTSyLj9W8C0vOhF2bA3voxX2Vb5Xv27oR8Xn6jKoR+/ZzK0Ch3aF06P+Xxto/ZGZyvdxsN+s2ldEu+vHbK6QwXC30/U+J8TFOQ0rIbZny3LOtaBK0sbflAdLNlQwaFmCfQ==",
      "isEncrypt": true
    },
    "api": {
      "signature": "{{signature}}",
      "apiKey": "{{Api-key}}",
      "credential": "{{cred}}"
    }
  }
});

req.write(postData);

req.end();

Body

{
    "method": "ledger.CARD.request",
    "id": "1",
    "params": {
        "payload": {
            "transactionType": "VALIDATE_CVV",
            "product": "DEFAULT",
            "channel": "VISA_DPS",
            "program": "DEFAULT",
            "cardId": "6f586be7bf1c44b8b4ea11b2e2510e25",
            "cardCvv": "fbbVg8NQFDwa5rtkjR+Wa4wqiZwUWoxaUVLO2fTFgeYvQ9RGBfyl6H0rpCvtEoEbhbVFTuJGX8hdgjfptOynnrKD5DUFpK0RDi+URuKIunzbiQ9Gq6iqs54S2LaWH0ZVwsvPb4HiP1mOX88oV7xZc7rzWcG1nOBErogItPTijlG/UMvVWU0SYMd+fjBNqMcdMeFe3GLch3KMFpAC4yC+sTSyLj9W8C0vOhF2bA3voxX2Vb5Xv27oR8Xn6jKoR+/ZzK0Ch3aF06P+Xxto/ZGZyvdxsN+s2ldEu+vHbK6QwXC30/U+J8TFOQ0rIbZny3LOtaBK0sbflAdLNlQwaFmCfQ==",
            "isEncrypt": true
        },
        "api": {
            "signature": "{{signature}}",
            "apiKey": "{{Api-key}}",
            "credential": "{{cred}}"
        }
    }
}

Response: 200

Response Parameters

Parameters	Description
Id	String Response ID echoed from the request ID Sample Value: "1"
result	Object
cardId	String Unique ID of the card for which the CVV validation was performed Sample Value: "6f586be7bf1c44b8b4ea11b2e2510e25"
api	Object
type	String Acknowledgement for type of operation requested for Sample Value: "VALIDATE_CVV_ACK"
reference	String Unique reference for the API response Sample Value: "REF"
dateCreated	Number Unix timestamp of the response was created Sample Value: 1732087371
message	String Message indicating the response of CVV validation process, confirming that the CVV provided was correct and has been validated Sample Value: "CVV has been validated successfully"

{
  "id": "1",
  "result": {
    "cardId": "6f586be7bf1c44b8b4ea11b2e2510e25",
    "api": {
      "type": "VALIDATE_CVV_ACK",
      "reference": "REF",
      "dateCreated": 1732087371
    },
    "message": "CVV has been validated successfully"
  }
}